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DefaultComponentReglstry 



-DefaultComponentRegistry minstance=new DefauitComponentRegistry() 

-MbeanServer mMyMBEanServer 

-String mG2MbeanDomaln 

-String mDefaultDomain 

-String mHostlpString 

-String mProcessldString 

-Hashtable mRegisteredComponent 

-DefaultComponentReistryO 
-void lnit() 

-void reisterMBeanOb]ect( String domain, Object obj, Hashtable nvps) 

-void unregisterMBeanObject(ObjectName target) 

-void CleanUpMBeanServerQ 

-void regis terComponent(Cornponent c) 

-void unregisterComponent(Component c) 

-Component registerComponentAware(ComponetAware ca) 

-Component registerGenericComponent(ObJect o) 

-Component reglsterRmiConnectorServer(RmiConnectorServer o) 

-Component reglsterCascadingAgent(CascadingAgent o) 

-Component registrHtmlAdapterServer(HtmlAdapterServer o) 

-void cleanup () 

-Set flndOb)ectNames(AddressMask am) 

+Hashtable getComponentProperties(Component c) 

+ComponentReglstry getlnstance() 

+ComponentAddress lookupComponentAddress(ObJect o) 

+void waitForComponentRegistration(Strlng objectname, Int maxwaitseconds) 

♦Component registerObject(ObJect o) 

♦void unregisterObject(Object o) 

+void addNotificstionUstener(ObjectName name, NotlficstionUstener listener, java.lang.Objecthandback) 

+void lnvokeOnObject(AddressMask m, String method, ObjectQ params, StringQ signature) 

+void lnvokeOnObject(Objecto, String method, ObjectQ params, StringQ signature) 

+void invokeOnObject(ComponentAddress addr, String method, ObjectQ params, StringQ signaure) 

+Set findLocalObjectComponents(AddressMask props) 

+Set find6loba!ObjectComponents(AddressMask props) 



FIG 4A 
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ComponentReglstry 



+Component registerObject(Object c) 
+void unregisterObject(Object c) 

+void invokeOnObject(AddressMask addr, String method, ObjectQ params, StringQ signature) 
+void invokeOnObject(ComponentAddress addr, String method, ObjectQ params, StringQ signature) 
+void invokeOnObject(Object o, String method, ObjectQ params, StringQ signature) 
+void WaitForComponentRegistration(String objectname, int maxwaitseconds) 
+ComponentAddress lookupComponentAddress(Object o) 
+Set findLocalObjectComponents(AddressMask props) 
+set findGlobalObjectComponents(AddressMask props) 
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HostMaster 



-boolean misDebug 
-int mNextProcessld 
-VectormActiveProcesslds 
-boolean mlsAlive 
-ComponentRegistry mCRegistry 
-HostMaster mTheMaster 
-HostMasterComponentmHotMasterComponent 
-String mProcessPropsString 

+HostMaster() 

+lnt addProcessO 

+vo!d destroyProcess(lnteger pid) 

+void main(StringQ args) 

+void shutdown() 

+vold ki!I() 

+void SetLsDebug(boolean d) 
+boolean isDebug() 
♦boolean isAlive() 

-boolean getBoo!eanArg(String token, Stringfl args) 
+void processLost(int pid) 
+Class getComponentClass() 
-void recover() 

-ShutdownMonitor 



FIG 4C 
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ProcessAgent 


-int mMyPid 




-ProcessAgentComponent mAgent 




-ProcessAgent mAgent 




-NodeManager mNodeManager 




-boolan mlsAlive 




-ComponentRegistry mCRegistry 




+ProcessAgentOnt pid) 




+boolean IsAliveO 




+void main(StrlngD args) 




+void addNode(NodeType nt) 




+void removeNode(NodeType nt) 




+void startNode(NodeType nt) 




+void stopNode(NodeType nt) 




+void destroyProcess() 




♦void addNode(String nt) 




+vold removeNode(Strlng nt) 




+vold startNode(String nt) 




+vo!d stopNode(Strlng nt) 




+!nt getProcessld() 




+Class getComponentClassO 
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NodeManager 


-Vector mynodes 


+void Node Manage r() 




♦Node createNode(NodeType type) 




-void destroyNode(Node n) 




-void startNode(Node n) 




-void stopNode(Node n) 




+void destroyNode(NodeType nt) 




+void startNode(NodeType nt) 




+void stopNode(NodeType nt) 




+Node getNode(NodeType type) 




+lnteger activeNodeCount() 




+void recoverNodes() 





FIG 4E 
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ComponentAware 



+Class getComponentClass() 



FIG 4F 
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HostMasterComponent 



-String MBEANTYP E="HostMaster" 
-String MYBEAQN DESCRIPTION 
-int HEARTBEATRETRIES=1 
-int HEARTBEATPE RIOD=5000 
-HostMaster mHostlVlaster 
-HtmlAdapterComponent mHtmlAdapterComponent 
-Hashtable mRemAgents 
-ComponentRegistry mCRegistry 



+HostMasterComponent(ObJect hm) 

-CascadingAgent createCascadingAgent(String cascadingDomaln, String hostname, Int targetProcess 

+String getType() 

+vold processAdded (Int pid) 

+void processRemoved(lnt pid) 

+vold preReglsterO 

+vold preUnreglster() 

+vold handleNotlfication(NotIflcation n, Object o) 
+void processRecovered(int pid) 
#String getMBeaqnDescription() 

#ModelMBeanOperationlnfoD getMBenOperatlonsQ 
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ProcessAgentComponent 



+String MBEANTYPE="ProcessAgenP 
-String MYBEANDESCRIPTION^ 
-ProcessAgent mProcessAgent 
-RMIConnectorServerComponent mRMI Server 
-ComponentRegistry mCRegistry 

+ProcessAgentRegistry(Object pa) 

+ void preRegister() 

+void preUnregisterO 

+String getTypeO 

#String getMBeanDescrlption() 

#ModelMBeanOperationlnfoa getMBeanOperationsO 
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GenericComponent 



-String MYBEANDESCRIPTION^Object* , 
+GenericComponent(ObJect o) 
♦String getType() 

#String getMBeanDescriptionQ 
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Component 



♦String IDPROP^id" 
+String TYPEPROP= w type" 
+String HOSTPROP^host* 
♦String PROCESSPROP^process" 
♦String NODEPROP="node* 
-t-String SERViCEPROP^servIce'' 

♦String getld() 
♦String getType() 
♦String getServiceO 
+String getNode() 
+String getAdminDoma!n() 
+Object getObject() 
♦Object getMBEanO 
+String getHostld() 
♦String getProcessldO 
+vold preRegIster() 
+vold preUnregisterQ 
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Com pone ntBase 



-Object mTheObject 
-String mObjectDescriptlon 
-Object mTheMBean 
-ArrayUst mMBeanOperatlonlnfb 
-ArrayUst mMBEANAttributelnfo 
-ArrayList mMBeanNotificationlnfo 
-String mHostlp 

-String mProcessId 

+ComponentBase(Ob]ect o) 

+boolean isMBea n(Object o) 

+String get!d() 

♦String getType() 

+String getService() 

+string getNode() 

+ObjectgetObject() 

+vold preRegisterO 

+void preUnregister() 

+Object getMBeanO 

#void setObjectDescription(String desc) 

#ModelMBeanOperatinglnfoD getMBeanOperations{) 

#ModelMBeanAttributelnfoQ getMBeanAttributes() 

#ModeIMBeanNotiflcatlonlnfoQgetMBeanNotifications() 

#String getMBeanDescriptionO 

-void setupMBeanlnfo() 

+String getAdmin Domain () 

+String getHostlP() 

♦String getProcessld() 



FIG 4K 
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G2Component 



+G2Component(Object o) 

♦String getAdminDomainQ 

FIG 4L 
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AdminComponent 



+AdminComponent(Object o) 
♦String getAdminPomalnQ 
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CascadlngAgentComponent 


♦String MBEANTYPE= n CascadingAgenr 




+Strlng CONNECTORCLIENTCLASSNAME= w com.sun.i- 




+CascadingAgentComponent(CascadingAgent agent) 




+String getld() 




+String getType() 
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HTMLAdaptorComponent 


-String HTTPCONNECTIONSERVER 




-HtmlAdaptorServer mHtmlAdaptor 




+HtmlAdaptorComponent(HtmlAdaptorServer has) 




+String getTyp8() 
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RMICorinectorServerComponent 


+Strlng RMICON NECTORSERVER= tt RmiConnectorServer" 




+String RMICONNECTORSERVICENAMEPREFIX^Process-" 




-RmlConnectorServer mTheRmlConnector=null 




+RMIConnectorServerComponent(RmiConnectorServer o) 




+String getRMIConnectorServiceName(int targetProcessId) 




+String getType() 





FIG 4P 
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• ServlceComponent 



-BaseServlce m__Service 

-String MYBEANDESCRlPTION="A Service- 

+ServiceComponent(Object s) 

+String etType() 

+String getNode() 

#String getMBeanDescription() 

#Mode)MBeanAttribute)nfoQ getMBeanAttributes() 

#ModeiMBeanOperationlnfoD getMBeanOperation 

FIG 4Q 
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NodeComponent 


-String MYMBEANDESCRIPTION="A node : runs a set" 
-MasterNode mNode 


+NodeComponent(Object n) 




+String getType() 




#String getMBeanDescriptionO 




#ModelMBeanAttributelnfoD gelMBeanAttributesO 




#ModelMBeanOperationlnfoD getMBeanOperatlons() 




FIG 4R 
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NodeAdmin 


+Node createNode(NodeType type) 




+vo)d startNode(NodeType nt) 




+vold stopNode(NodeType nt) 




+Node getNode(NodeType type) 




♦Integer actlveNodeCount() 




+vold recoverNodes() 





FIG 4S 



50 



G2Runtime 



-G2Runtlme m!nstance=new G2Runtime() 
-int mProcessld 
-String mHostldString 

-G2Runtme() 
+void init() 

+ComponentRegistrygetComponentRe0!stry() 
+String getHostJd() 
+int getProcessldO 
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ComponentAddress 



-Hashtable mAddressAttributes 

-String HOST=G2Runtime.getHostlp() 

-String PROCESS=" ,, +G2Runtime .getProcessld() 

-AddressAttributeO mAttributeUst==new AddressAttributefl 



+ComponentAddress newAddress() 

+ComponentAddress getAddress(Component c) 

-ComponentAddress(Hashtable props) 

-ComponentAddressO 

+Hashtable getAttributes() 

+void setAttribute(AddressAttribute aa) 

+AddressAttribute getAttribute(String name) 

+boo!ean isCompteteQ 

^boolean equals(Object o) 

+String toString() 



FIG 4U 
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MBeanConfig 



+int RMIPORT=1099 

+int HTTPPORT=8080 

♦String G2DOMAQlN="G2Domain ,, 

+String DEFAULTDOMAIN= H DefaultDomain M 

+StringPIDPROPERTYNAME= M g2.processid" 
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conm8rtleirt.ptetfofnuKHteJtocteFactoiy 

.Qbleeinn NODEDEFB=J i NodeTVpeA 
-NodeFactorvlnstances newNodeFaetorvO 
#NodBFactoiyO 
♦NpdBfactotYqetlp^anceO 
♦NodaO createNod8s(NodcTypeO nodetype) 
♦Node craat9Node(Node*rypa nodafype) 
" -void JoadNodeDefsO 
-UnkedUstgetAppIlcatlonAdapterSeivlceUsI 
-UnkadUst gelCllanWdapterSarvlCBUstO 
-UnketJUsI getBPStoreSarviceUstO 
-UnkedUsI gerTMServJcaUslO 
-UnkadUsl getSystamManagerSeiYlceUstO 
*Unk8dLlst gatDebugNodeSeivIceUstO 



FIG5A 
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Interface 
...ptatform.node.Node 

+volctfnft0 
+voidstartO 
+vofd6top0 
+voiddestroyO 
+void recoverO 



FIG 5C 
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Interface 
com. Qenientpfetfotm.utiLPooi 

+void refease0bjeci(0bject o) 
+ Object getDbjectQ 
+ M getA valiabieGountQ 
+intgetSizeO 
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I 

ComponentAware 
...platform.nodB.MasterNode 
-Thread mEventNotifier 
-NodeTypetype 
-String subType 
-HashMap mStateTransitions 
-HashMap mServices 
-HashMap mUsteners 
-boolean islnitlalised 
-boolean removed 
-String lastErron=NOERROR 
-String NQERRQR= M N9NF 
-Node mState 
-Pool mRouterThreadPool 
-Cache mCache 

-AddressableReqistry mAddressal: 

-void notKyListenersO 

-void seflype(NodeTypetype) 

-void startServlcesO 

-void stopServlcesO 

♦String getLastErrorO 

+NodeType getP/peO 

+Node getStateO 

+String getStateDescriptlonO 

-void InitRouterThreadPoolO 

#void addService(HandlerContexts 

#void removeSeivicesO 

+ MasterNodeO 

+void addUstenerO 

+vold removeListenerO 

+void startO 

+vold stopO 

+vold setSubType(Strlng st) 
+Strlng getSubTypeO 
+void InitO 
+void destroyO 

♦Integer getAvailableRouterThread 
+RouterThread getRouterThreadQ 
+void releaseRouterThread(Router 
♦Class getCornponentCiassO 
+void recoverO 

#void setState(Node newState) 



FIG 5D 
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I 

Thread 
AutoPootRefeasfng 
..ptatfonm.nodeJloirterThread 
-Pool mMyPool 
•boolean mlsNextMsg 
•boolean mRunnlng 
-MessageRouter mTarget 
•Message mMessage 
-MessageRouter mNexfT arget 
-Message rnNextMessage 

•Semaphore mRouterSignal 

+ RouterThreadQ 

♦void setPool(Pool p) 

+vold route(MessageRouter sink, W 

+vold startO 

+void haltO 

+vold runO 

♦boolean IsRunnlngO 



FIG 5E 
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^m.genient.p!atform.nocle.nmeStampedCache 
•m.cacheDala Map 

Object getObJect(StrIng name) 
. +vold addOb)ect(Strlng name, Object value) 
+void removeObject(Strlng name) 
+vold updateOb)ect(Strlng name, Object value) * • 
-void startUpdateTracklngO 
-void endllpdateTrackingO 
•Map getUpdatedObJectsO 
-List getDeletedObJectsO 



61 

coragenlentplatforranotte JtepPcatetiCac he 



+0bJectget0bJect(8trlng name) 

+vold addObJect(Strlng name, Object value) 

+vold removeObJect(Str1ng name) 

♦void updateObJect(String name, Object value) 

•void updateRemoteCopyQ 

-void setCheckPolntQ 

-HashMapgetModlfledSinceCheckpolntO 

•Ust getDeletedSlnceCheckpolntO 

-void clearCheckPolntO 



FIG 5F 
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interface 

com.geiventptatform.nod&Cacfie 



+vokt addObfect(String name, Object value) 
+vokt removeObjeci(Slrfng name) 
*vofcf upctateObfect(Strfng name, Object vatue) 
+ObJectgetObject(String name) 



FIG 5H 
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■.node.AddressableRegistry 

+void registerAddressable(Adressc 
+void unregisterAddressable(Adres 
+Addressable lookup(AddressMas 

FIG 51 



FIG 5G 
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Node 

,.platform.node.AbstractNode 



gMastgrNgde mCtx 
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ComponentAware 
.ptetfornilramewor&BaseService 



-int mMessageSendCount 
-int mMessageReceivedCount 
-float mMsgAvg 

-HashMap mMessageUsteners 
-int mResultsHandled 
-intmResultsMissed 
-MasterNode mNode 
-ServiceType mType 
-SeivlceState mState 
-Pool rnServIceableHandlerPool 
-PriorftyQueue mlnQueue 
-PriorityQueue mOutQueue 
-MessageDlspatcher mMylnDispati 
-MessageDlspatcher mMyOutDIsp: 
-ComponentAddress mMyAddress 
AddressableRegistry mReglstry 



^constructor** 
+ BaseService(ServlceType service 
+vold injtService(Strlng host, String 
♦SeiviceType getTypeO 
#void sendServiceMessage(Messa 
+vold route(Message msg) 
+vold updateMessageStat!stics(Me 
+ComponentAddress getAddressQ 
#vold initHandlerPool(Vector handli 
+vold startServlceO 
+void stopSeivlceO 
+MasterNode getNodeO 
integer getStateO 
+lnteger getlnQueueSizeO 
+lnteger getOutQueueSizeO 
-•■Integer getMessagelnCountfl 
+lnteger getMessageOutCountQ 
+String getAverageMessageAgeQ 
+lnteger getAvailableHandlersQ 
#Queue getlnQueueQ 
#Queue getOutQueueQ 
+vold addResultLlstener(Messagel 
+ResultListener removeResultLisft 
♦Integer getResultLlstenersCountC 
+vojd receivedResultO 
^Integer getResultsHandledO 
+vold mlssedResultO 
+lnteger getResultsMlssedQ 
+ Class getComponentClassQ 



-MessageToHandlerForwarder 
MessageToRouterForwarder 
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interface 

com. Qenientpfatforrn. framework.HandterContetf 



^-ServiceType getTypeO 
+ void route(Message msg) 
+ComponertiAddress getAddressQ 
+tntegergetStateO 

+void addResuftListener(Messagetd repiyToid, ResuitListener target 

+ResuitListener removeResuftLfstener(Mes$ageid repfyToid) 

+void registerAddresaabfe(Addressabfe obj) 

+void unregisterAddressabfe(Addressabie obj) 

+ArrayUst fookvpAddressabfes(AddresaMask mask) 

+void addResuttListener(Messageid repfyToid, ResuttListener target} 

+void addPersfstentResuflListenerfMessageid repfyToid, ResuftListe* 
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AutoPoofReteasing 
ReauitListener 
. tiwneworfLBaseSovfceHantfer 



-Pool mMyPool 
•HandlerContext mMyParent 
-CommandBcecutor mMyExecutor 
■Message mCurrentMessage 



BaseServiceHandlerCHandlerConte* 
♦void setPool(Pool p) 
♦Message getCurrentMessageO 
♦void handleMessage(Message msg) 
+void route(Message msg) 
+void deliverResult(ObJect o) 
+ComponentAddress getAddressO 

HandlerContext getParentQ 



CommandExecutor 



FIG 7C 
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Thread 

.services.MessageDispatcher 



-Queue mWaitQueue 
-MessageRouter mTarget 
■boolean mRunnlnq 



+ MessageDispatcher(Queue q, Me 
+void startO 
+void runO 
+void haltQ 



.platform.services.Sen/iceFactory 



-ServiceFactorv instance=null 



•ComponentRecjlstry mCReqistiv 



#ServiceFactoryO 
+ServiceFactorv aetlnstancen 
+HandlerContext getSeivice(Mastei 



FIG 7E 
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Seriatizabfe 
.platform^eivices.ServiceState 



-byte mlndex 
-String mName 

-PVte RUNNING INDBfafJ 



■We STARTING 1NDEX=1 
bvte STOPPED INDEX=2 
■bvte STOPPING INDE)fa3 
bvte RECOVERI NG INDEX=4 



-byfe FAILEQ 1NPEX=5 



nServlceState RUNNING=new Sen, 



^ServlceState STARTING=new Sen 



+ServlceState STOPPEP=new Sei> 



-ServlceState STOPPING=newSer 



•ServlceState RECOVERINO=new 



•ServlceState FAILED=new Service 



String toStrfngQ 
boolean equals(Objectobj) 
+ServlceStatefromlntflnt 



IndBx), 



Int InfValueO 
-Object readResohreO 



FIG 7F 
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+UserResponse (srciAddressable, rec 
+MessageType getTypeO 
-CommandTargetPair getFailureDelivi 
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Parameter 


Req. 


Type 


Values 


Notes 


g2jms.config 


Y 


Str 




File containing the jms configuration properties for the 
Listener 

e.g. g2jms.config=c:\con1\jms.properties 


g21istener 


Y 


Str ! 




This is the name of the node under the UAconfigs node 
in the IDM containing the listener configuration, 
e.g. g2listener=webllstener 


g2config.instance 


Y 


Str 




Node in the IDM that has an instance definition for the 
Composite Application, [shouldn't be necessary but is 
In current release 
e.g. g2config.instance=googleweb 


g2config.home 


Y 


Str 




Directory containing the IDM properties file for the 
Composer/Listener. This has to point to a directory 
containing the file rather than the file, 
e.g. g2config.home=c:\GCP\2.3.0\conf 


g2tracer.conf 


Y 


Str 




File containing the logger configuration for the Listener, 
e.g . g2tracer.conf^c:\confMistenerlog .conf 



FIG16 



Parameter 


Req. 


Type 


Values 


Notes 


G2config.home 


Y 


Str 




Directory containing the IDM properties file for the 
Composer/Listener. This has to point to a directory 
containing the 'IDM.properties' file rather than the file 
itself 

e.g. g2config.home=c:\GCP2.3.0\conf 


g2config.instance 


Y 


Str 




Node in the IDM that has an instance definition for the 

Composite Application. 

e.g. g2conflg.instance=googleweb 


g2config.webhost 


Y 


Str 




Host-name (or IP address) and port, of the Web Server 
used with the Listener. Used to rewrite the pages 
served up through the composer to point back to the 
listener. 

e.q. g2confiq.webhost=1 92. 1 68.1 .229:80 


g2config.baseipport 


Y 


Str 




Specify the Admin console port 

e.q. g2config.baseipport=8080 


g2jms.config 


Y 


Str 




File containing the jms configuration properties for the 
Composer 

e.g. g2jms.config=c:\conf\Jms.properties 


g2basetracer.conf 


Y 


Str 




File name containing the logger configuration^) for the 
Listener - It will look for a file per process so there 
needs to be at least a '0' and a T log file, 
e.g. g2tracer.conf=c:\conf\composeriog.conf 
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Name 


Req. 


Type 


Values 


Notes 


APPLICATION C 
LASS 


Y 


Str 




Destination service for the incominguserrequest 
message that will be generated. This Is the application 
class name used for the composite application. 


UXM_MODIFIED 


Y 


Str 


true/false 


Set to true if the request is to be processed by the 
Composer. If false, then the UXM will not process the 
request and pass it on to the AA (pass through 
applications) 


UXM TREEDD 


Y 


Str 




The 'Id' (from the control data-group) of the 
TreeRootNode targeted by this request 


UXMJSfODEID 


Y 


Str 




The 'id' (from the control data-group) of the TreeNode 
(within the hierarchy defined by UXMJTREEID) 
targeted by this request 



FIG 18 



hm.g2config.baselpport=9O80 
hrn.rmiport=1299 

hm.g2config.webhost=10.230.226.1 62 

hm.g2config.instance=My I nstance 

hm.g2jms.config=/usr/genient/composer/conf/ims.properties 

hm.g^tra(»r.(X3nf=/usr/genient/composer/conf/composer-log.properties 

pa.x.Xms512m 

paj(.Xmx512m 

paxXXA:NewSize=64m 

pa.x.XX\:MaxNewSize=64rn 

pa.x.XX\:+DisableExpllcitGC 

pa.x.g2config.webhost=1 0 .230.226. 1 62 

pa.x.g2config.home=/usr/genient/composer/conf 

pa.x.g2config.instance=Mylnstance 

pa.x.g2jms.config=/usr/ge n ient/composer/conf/jms.properties 

paxg2tracer.confWusr/genient/ccMTiposer/con^composeNog.properties 

pa.x.Javax.netssl.trustStore=/usr/genlent/j2re1_3_1_08/Iib/security/g2cert 

pa.x.javax.netssl.keyStoreType=pkcs12 

pa.x.javax.netssl.keyS tore Password =thgirwtfos 

paxjavax.netssl.keyStore=/usr/genientfl2re1JMJ)8/^ 

pa.x.Java.protocol.handler t pkgs=HTTPClient 
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